Account updated webhook
info
📘 Para saber mais sobre webhooks em nossa API, siga o link abaixo:
Esta página descreve o webhook ACCOUNT_STATUS_UPDATED, que é disparado sempre que ocorre alguma alteração em uma conta cadastrada.
Headers​
| Nome | Descrição |
|---|---|
| x-delbank-api-key | Obrigatório. Chave de API |
| x-delfinance-account-id | Obrigatório. O número da conta Delfinance. |
Corpo da requisição​
{
"bankAccount": "999999",
"eventType": "ACCOUNT_STATUS_UPDATED",
"url": "your.url.test.com",
"authorization": "NONE",
"authorizationScheme": "NONE"
}
Exemplo de resposta quando o webhook é criado:
{
"id": 1234,
"bankAccount": "999999",
"eventType": "ACCOUNT_STATUS_UPDATED",
"url": "your.url.test.com",
"authorization": "NONE",
"externalId": null,
"createdAt": "2025-03-02T12:14:06.0613001Z",
"updatedAt": "2025-03-02T12:14:06.0613227Z",
"authorizationScheme": "NONE"
}
💡 O webhook usa o mesmo esquema ao enviar eventos; você pode reutilizar este objeto como referência.
Exemplo de payload do evento​
{
"bankAccount": "999999",
"eventType": "ACCOUNT_STATUS_UPDATED",
"status": "BLOCKED",
"updatedAt": "2026-03-06T13:31:47.9997672Z"
}
Atributos enviados pelo ACCOUNT_STATUS_UPDATED​
| Nome | Descrição |
|---|---|
| bankAccount | Número da conta Delfinance cuja informação foi alterada |
| eventType | Tipo de evento que disparou o webhook (sempre ACCOUNT_STATUS_UPDATED) |
| status | Status atual da conta (ex: ACTIVE, BLOCKED) |
| updatedAt | Timestamp em que a alteração ocorreu |